通过创建 balance_transfer
对象发起用户间的余额转账。转账完成后可以调用 user
对象查询接口,查询用户的余额。转账的余额可以消费、再次转账和提现。注: 使用此接口必须保证用户可提现余额大于0。
属性 | 描述 |
---|---|
id string | 用户余额转账对象 ID,由Ping++ 生成。 |
object string | 值为 "balance_transfer"。 |
app string | 对应 app 对象的 id ,查看 如何获取App ID。 |
created timestamp | 创建时间,用 Unix 时间戳表示。 |
livemode boolean | 是否是 live 模式。 |
status string | 目前值为转账成功:succeeded 。 |
amount int | 接收方收到转账的金额,单位为分。 |
order_no string | 商户订单号,适配每个渠道对此参数的要求,必须在商户的系统内唯一。 |
user_fee int | 向发起转账的用户额外收取的手续费,单位为分,且值需小于 amount。 |
user string | 转出方的 user 对象的 id 。 |
recipient string | 接收方的 user 对象的 id 。 |
user_balance_transaction string | 转账关联的转出方 balance_transaction 对象的 id 。 |
recipient_balance_transaction string | 转账关联的接收方 balance_transaction 对象的 id 。 |
description string | 附加说明,最多 60 个 Unicode 字符。 |
metadata hash | 详见 元数据。 |